﻿<!DOCTYPE HTML>
<html lang="zh">
<head>
<title>设置托盘图标 - 语法 &amp; 使用 | AutoHotkey v2</title>
<meta name="description" content="The 设置托盘图标 function changes the script's tray icon (which is also used by 界面 and dialog windows)." />
<meta name="ahk:equiv-v1" content="commands/Menu.htm#Icon" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<link href="../static/theme.css" rel="stylesheet" type="text/css" />
<script src="../static/content.js" type="text/javascript"></script>
<script type="text/javascript">$(function(){0<=window.navigator.userAgent.toLowerCase().indexOf("ucbrowser")&&CaoNiMaDeUc()})</script>
</head>
<body>

<h1>设置托盘图标</h1>

<p>更改脚本的<a href="../Program.htm#tray-icon">托盘图标</a>(它也被 <a href="../objects/Gui.htm">GUI</a> 和对话框窗口使用).</p>

<pre class="Syntax"><span class="func">设置托盘图标</span>(<span class="optional">FileName, IconNumber, Freeze</span>)</pre>
<h2 id="Parameters">参数</h2>
<dl>

  <dt>FileName</dt>
  <dd>
    <p>类型: <a href="../Concepts.htm#strings">字符串</a></p>
    <p>图标或图片的路径. 有关支持格式的列表, 请参阅<a href="GuiControls.htm#IconSupport">图片控件</a>.</p>
    <p>指定星号(*) 将脚本恢复到其默认图标.</p>
  </dd>
  
  <dt>IconNumber</dt>
  <dd>
    <p>类型: <a href="../Concepts.htm#numbers">整数</a></p>
    <p>要使用文件中除第一组图标之外的图标组, 请在 <em>IconNumber</em> 指定它的编号(如果省略, 则它默认为 1). 例如, <strong>2</strong> 将加载第二组图标中的默认图标. 如果 <em>IconNumber</em> 为负数, 则假定其绝对值表示可执行文件中图标的资源 ID.</p>
  </dd>
  
  <dt>Freeze</dt>
  <dd>
    <p>类型: <a href="../Concepts.htm#boolean">整数(布尔值)</a></p>
    <p>指定 1(true) 来冻结图标, 或 0(false) 来解冻它(或留空来保持冻结/解冻状态不变). 当图标已经冻结时, <a href="Pause.htm">暂停</a> 和 <a href="Suspend.htm">挂起</a> 不会改变它. 注意: 要冻结或解冻 <em>当前</em> 图标, 请使用 1(true) 或 0(false), 如下例所示: <code>设置托盘图标(,, 1)</code>.</p>
  </dd>

</dl>

<h2 id="Remarks">备注</h2>
<p>改变托盘图标同时也改变由 <a href="InputBox.htm">输入框</a> 和后续创建的  <a href="../objects/Gui.htm">GUI</a> 窗口显示的图标. 也会影响<a href="../Scripts.htm#ahk2exe">已编译脚本</a>, 即使它在编译时指定了自定义的图标. 注意: 如果之前使用如 <a href="_NoTrayIcon.htm">#无托盘图标</a> 的方法隐藏了托盘图标, 则改变图标不会让它显示出来; 要让它显示, 请使用 <code><a href="../Variables.htm#IconHidden">内_隐藏图标</a> := false</code>.</p>
<p id="distort">从 .ICO 外的其他类型文件中加载托盘图标时可能产生轻微的变形. 尤其是对于 16x16 的图标. 要避免此问题, 请把要使用的托盘图标保存为 .ICO 文件.</p>
<p>操作系统的 DLL 和 CPL 文件包含的一些内置图标可能会有用. 例如: <code>设置托盘图标 "Shell32.dll", 174</code>.</p>
<p><a href="../misc/ImageHandles.htm">位图或图标句柄</a>可替代文件名. 例如, <code>设置托盘图标 "HBITMAP:" handle</code>.</p>
<p>内置变量 <strong><a href="../Variables.htm#IconNumber">内_图标编号</a></strong> 和 <strong><a href="../Variables.htm#IconFile">内_图标文件</a></strong> 分别包含了当前图标的编号和名称(带完整路径)(如果为默认图标则两者都为空).</p>
<p>托盘图标的工具提示可以通过给 <a href="../Variables.htm#IconTip">内_图标提示</a> 赋值来更改.</p>

<h2 id="Related">相关</h2>
<p><a href="_NoTrayIcon.htm">#无托盘图标</a>, <a href="TrayTip.htm">托盘提示</a>, <a href="../objects/Menu.htm">Menu 对象</a></p>

</body>
</html>